Skip to content

docs(saiph): design Saiph, a Scion-style VCS (RIG-5665) - #48

Closed
rigel-mintaka wants to merge 4 commits into
mainfrom
compass-vcs/rig-5665-internal-vcs-design
Closed

rigel-mintaka wants to merge 4 commits into
mainfrom
compass-vcs/rig-5665-internal-vcs-design

Conversation

@rigel-mintaka

@rigel-mintaka rigel-mintaka commented Oct 18, 2026 •

Copy link
Copy Markdown
Contributor

Summary

This is the design set for Saiph, Rigel's own version-control system. It follows Scion closely (Redesigning source control at Anthropic). Saiph is its own product and will live in its own repo, RigelBuild/saiph. Compass is its first client, and RIG-5558 continues unchanged as the git backend.

The set lives at docs/designs/saiph/:

Record Covers
README.md Overview, rulings, glossary, component map, work order, and an index of every open question
store.md Changesets, blobs, refs, derived data, the saiph.v1 API, the metadata database, tenancy, ACLs, and deviations from Scion
client.md Our own saiph CLI, saiphd daemon and saiph-cache; want-only fetch; sparse and virtual checkouts; tokens; agent tools
review.md Changes, versions, stack DAG, threads, approvals, the attention set, and readiness to land
merge-queue.md Lanes without a global lock, speculative batches, bisection, auto-rebase, and the cheap-model fixer for trivial conflicts
ci-cd.md saiph-ci on k8s Jobs, presubmit and postsubmit, TAP-style culprit finding, Rapid-style CD, and the REAPI cache
git-bridge.md Trunk-only export to GitHub, history import, and per-repo cutover

Ledger

  • DL-578..DL-581 moved to the saiph surface and were rewritten.
  • New: DL-590..DL-626.
  • internal-vcs.md (the first draft) is deleted.

Rulings folded in

From Matt, recorded in RIG-5821:

  • Scope:
    • Follow the full Scion design for server and client.
    • Saiph is its own product and repo.
    • Today's Saiph UI is renamed Sirius (RIG-5879).
    • Two backends: the git backend stays.
    • Agents on a native repo have no GitHub egress.
  • Client: our own, not jj.
  • Mirror: only trunk is mirrored to git.
  • Review: stacks form a DAG.
  • CI/CD: runs on k8s.
  • Merge queue: batching and bisection, plus a cheap-model fixer.

Status

Draft, not ready to merge. The open questions are indexed in README.md. The load-bearing ones must be answered before the record freezes.

Preview: https://compass-vcs-rig-5665-interna.docs-2ui.pages.dev/designs/saiph/readme/

Gates

  • rumdl is clean on 48 files.
  • design-ledger-gate is OK.
  • ref-gate is clean.

@linear-code

linear-code Bot commented Oct 18, 2026

Copy link
Copy Markdown

RIG-5665

@github-actions

github-actions Bot commented Oct 18, 2026 •

Copy link
Copy Markdown

Rigel public design docs preview: https://compass-vcs-rig-5665-interna.docs-2ui.pages.dev

Deployed from compass-vcs/rig-5665-internal-vcs-design at 184000c.

@rigel-mintaka
rigel-mintaka marked this pull request as ready for review October 18, 2026 22:16
@rigel-mintaka

Copy link
Copy Markdown
Contributor Author

Review note at head 286ad478:

  • Reviews run: a design-critic red-team, plus one full review (4 high, 6 medium, 1 low).
  • Findings: all 11 are folded in 286ad478. None are open.
  • Checks: check and deploy are green.
  • Waiting on: OQ-1 to OQ-6 need Matt's ruling (RIG-5821). The record freezes when it lands.

Comment thread docs/designs/compass/internal-vcs.md Outdated
Comment thread docs/designs/compass/internal-vcs.md Outdated
Comment thread docs/designs/compass/internal-vcs.md Outdated
Comment thread docs/designs/compass/internal-vcs.md Outdated
Comment thread docs/designs/compass/internal-vcs.md Outdated
Comment thread docs/designs/compass/internal-vcs.md Outdated
Comment thread docs/designs/compass/internal-vcs.md Outdated
Comment thread docs/designs/compass/internal-vcs.md Outdated
@rigel-mintaka
rigel-mintaka marked this pull request as draft October 18, 2026 22:23
rigel-mintaka and others added 4 commits October 19, 2026 07:37
Server-held change store grown from the RIG-5558 T10 mirror; agents fill and sync jj only from the Server; GitHub stays the mirror and landing path. Files DL-578..DL-581. Six open questions for Matt.

Refs RIG-5665

Co-authored-by: Matt Wilkinson <matt@rigel.build>
…RIG-5665)

Per Matt's round-1 rulings on docs#48: a full Scion-style native VCS as a second backend beside RIG-5558. Replaces internal-vcs.md.

Co-authored-by: Matt Wilkinson <matt@rigel.build>
…D, git bridge (RIG-5665)

Moves the set to its own surface, docs/designs/saiph, per Matt (RIG-5821): Saiph is its own product and repo. Files DL-590..DL-626 and moves DL-578..DL-581.

Co-authored-by: Matt Wilkinson <matt@rigel.build>
@rigel-mintaka
rigel-mintaka force-pushed the compass-vcs/rig-5665-internal-vcs-design branch from 11d6253 to 184000c Compare October 19, 2026 11:38
@rigel-mintaka rigel-mintaka changed the title docs(compass): design Compass-internal VCS (RIG-5665) docs(saiph): design Saiph, a Scion-style VCS (RIG-5665) Oct 19, 2026
@rigelbuild-bot

Copy link
Copy Markdown

Superseded by RigelBuild/orion-docs#62. Saiph stays private until ship (RIG-5821), so the design set moved to the private design docs under orion ledger ids DL-567..DL-607. The compass ids DL-578..DL-581 and DL-590..DL-626 claimed on this branch are released. Closing.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants